The SI02ZuSB- 
Interface 


liser Manual 


Version 1.00, as of October 21s!t 2007 


for ATARI’”" 400/800/XL/XE Computers 
by ABBUC-RAF (ABBUC Regional Group Frankfurt) 


Advice and Warnings 


% before first connecting and starting up the SIO2USB 
please read chapter 2.5! 


The sign % means ATTENTION, WARNING! Pay special attention here. 


Examples, Inputs and Output on the screen of the SIO2USB are written in 
this font: 


Example Input 


You read this on the screen 


Important instructions are printed in bold. 


ATARI"” and the ATARI-Logo are trademarks of the company ATARI Inc. (U- 
SA), respectively ATARI Europe, respectively of the company Infogrames En- 
tertainment. 


See their webpages for further information: 
Infogrames http://corporate.infogrames.com/ 
Website ATARI Germany http://www.atari.de 


TurboDOS is © ATARI Bit Byter Club (ABBUC) e.V. 
Use is allowed by courtesy of ABBUC e.V. 
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1. Welcome to the SIO2USB! 


1.1.  Shipment 

1. A SIO2USB-Interface with attached SIO cable 

2. One USB-Stick with software and user manual in electronic form 
3. This user manual 

4. Asupplementary leaflet with warnings 

5. Areference card for the SIO2USB-Shell-software 

6. Acardboard box 


1.2. Specification 


The SIO2USB-Interface is a compact device capable to simulate up to three 
disk stations on the user's ATARI’" computer. Instead of real 5 !/4" diskettes, 
as in former times, the user can load and use disk images in ATR format sto- 
red on USB Flash drive in PC-format. Additionally the SIO2USB-Interface con- 
tains an internal memory where disk images can also be stored. This memory 
should be used for copies only, the work media is the USB Flash drive. The 
SIO2USB can operate in High-Speed mode at a transfer rate of 56.000 baud - 
long load times are history! 


The SIO2USB-Interface is powered from the SIO-Bus - no external supply is 
needed. Neither a driver is necessary to be loaded into the ATARI’”. The A- 
TARI"" computer does not recognize that instead of a real 810, 1050 or XF551 
disk station the SIO2USB is working absolutely tranparent. As well a PC is not 
needed to make full use of the SIO2USB-Interface. 


The selection and exchange of diskettes can be done by using the four buttons 
while the built in display shows the disknames or the menue. Alternative to the 
use of keys these and other funtions as creating disk images or subdirectories, 
delete/rename/copy of images can be done by use of the delivered ATARI"" 
software. 


The software of the SIO2USB-Interface can be updated by using the update 
program without additional means. So functional upgrades or bug fixes are 
possible without need of special hardware or shipping back the interface. 
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1.3. Information Sources 


1.3.1. User Manual 
This manual contains all important information necessary to operate the 
SIO2USB interface. 


This Manual will be stored on the USB-stick as a PDF file (in the current versi- 
on). 


1.3.2. Web-Ressources 

On the website www.abbuc-raf.de you can find the latest software for the 
SIO2USB interface, the Shell software for using the SIO2USB via the ATARI" 
computer and the latest version of the printed materials (this manual, reference 
card). 


1.3.3. Technical Support 
Atechnical support is available via email: 


sio2usb-support@abbuc-raf.de 


Please remember that the developers are hobbyists but not acompany. Plea- 
se do not contact the developers via phone. Please send in your questions via 
email or use the web-address. 
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2. The SIO2USB Device 


2.1. _Connectors 
On the right side of the device case is a SIO interconnection cable fixed. 


On the left side of the device case is a USB connector fixed to plug in a USB 
Flash drive (power consumption max. 100mA,). 


2.2. Indicators and Display 
On the upper left side of the SIO2USB-Interface four LEDs are installed. 


« POWER: the most upper LED lights up green when the device is powered 
via the SIO bus. 


« ERROR: the second LED from top lights up red when a error occures. See 
the error codes in chapter 8. 


« MEMORY: the third LED from top flashes yellow when read or write access 
to the USB Flash drive or internal memory is performed. 


« SIO: the fourth LED from top flashes yellow when data are transfered on the 
SIO bus. 


In the middle of the SIO2USB device is a Liquid Crystal Display (LCD) with 
four lines installed (in the following named display). The menu or the installed 
virtual disks and the functionality of the keys are shown there. 


2.3. Keys 


Directly right to the display are five keys installed. The function of the upper 
four keys depends on the displayed menu. Below them is another shorter key 
installed to reset the SIO2USB-Interface. 


2.4. Internal Memory 


Within the SIO2USB an internal memory is installed, that is permanently a- 
vailable. How to access and operate the internal memory is described in the 
chapters 4 and 5. Access to this memory is always possible even when no 
USB Flash drive is connected. 
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2.5. Warnings 


% All data on the USB Flash drive and internal memory are left at owner's 
risk. The user itself is responsible for backup copies of his data. 


% If the SIO2USB-Interface is opened or modified the support will become 
void immediately. 


% The maximum power consumption of the USB Flash drive must not ex- 


ceed 100mA. Only devices supporting "Bulk transfer only" mode and operating 
in "SCSI transparent" mode are appropriate. Most devices on the market 
should support this. 


% Only USB Flash drives with the given specification can be used. 


% The power consumption of the SIO2USB-Interface is approximately 


150mA plus the power consumption of the USB Flash drive. If your ATARI’“ 
computer is not upgraded e.g. with a RAM disk, a stronger power supply is 
necessary for your ATARI’“ computer (min. 2.5A at 5V). 


% The operation with a too weak power supply will lead to a overheated po- 
wer supply, system crashs or boot problems of the computer. 


% No USB hubs shall be connected! 


Never connect USB hard drives or CD/DVD drives that are powered by 
the USB port! This can distroy the SIO2USB-Interface and the ATARI(tm) 
computer. 


% Don't disconnect the SIO2USB or switch off the computer as long as one 
of the yellow LEDs is on. This can lead to data loss. 


% Disconnect the USB Flash drive only when no data are transfered visible 
when non of the yellow LEDs is on. Otherwise data can get lost. 


The ATARI(tm) computer must not be switched off as long as data are transfe- 
red. This is visible by the flashing yellow LEDs. 
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2.6. Display Adjustment 


On the rear side of the SIO2USB-Interface two openings are installed. Behind 
them two potentiometers for adjustment of the display brightness and contrast 
can be found. The hole on the left side near the USB plug is for contrast ad- 
justment, the hole on the right side near the SIO cable is for brightness ad- 
justment. 


To adjust contrast and brightness carefully slide in a screw driver in size 
1.8mm or 2.5mm and turn it until the blade fits to the potentiometer. 


Turning the screw driver counter clockwise reduces brightness and contrast, 
turning the screw driver clockwise increases brightness and contrast. Setting 


the potentiometers to the middle position should normally give good readability 


of the display. 
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3. Connecting the Interface 
3.1. Connecting the SIO2USB to the Computer 


1. Switch off the computer. 


2. Connect the SIO cable of the SIO2USB to the computer. It is possible to 
connect the SIO cable to any free SIO connector of a disk station which is 
connected to a computer. 


9. Insert the USB-Stick (“USB mass storage”) into the connector on the left 
hand side of the SIO2USB interface. 


4. Power on the computer. LED 1 “Power” should light up green and the dis- 
play on the SIO2USB should show the time and date, alternatingly. 


3.2. Connecting an USB-Stick to the SIO2USB 


Inserting an USB stick is possible while the system is powered on (hot plug- 
ging). In some cases this could cause a reset/restart in the SIO2USB. The 
ATARI"”Y computer is not affected by this. 
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4. Operation of the SIO2USB via Keys 
and Display 


The main functions of the SIO2USB interface can be used by pressing the built 
in keys. To use all the functions of the SIO2USB the “Shell” utility program is 
needed, see chapter 5 and chapter 6. 


4.1. Main Screen 


14:28:47 
D1# 


D2=DEMOS 
D3#TDOS21 


(example main screen) 


In the main screen you see the time and date (alternating) in the upper left 
corner. The three line below show the virtual disks stations D1 to D3 and the 
mounted disk images (if mounted) and their activation state. 


4.1.1. Call the menu 
If you press key 1 (the uppermost, to the right of the display) you will call the 
menu; on the display you see a “M” for menu next to the key. 


4.1.2. Activating disks / deactivating disks 

The keys 2-4 are labelled “D1” to “D3”. If you press one of them, the moun- 
ted disk image will be activated or deactivated/disabled (the same as switching 
a real disk station on or off). The symbols “=” and *-” mean activated, the sym- 


“m 


bols “#’ and “+” mean deactivated/disabled. 


“=” means drive active, all characters of the path and disk image name are 
shown 


“#’ means drive deactivated/disabled, all characters of the path and disk image 
name are shown 


[38] 


means drive active, because of the limited length of the display only the last 
chracters of the path and the file name will be shown 


“+” means drive deactivated/disabled, because of the limited length of the dis- 
play only the last chracters of the path and the file name will be shown 
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4.1.3. Swap Disk Images 

If you want to exchange the positions of two disk images, press the correspon- 
ding key of the first disk image and hold it, then press the corresponding key of 
the second disk image and release both of them. The disk images have ex- 
chaged their positions. 


% The SIO2USB only answers to disk input or output while the main 
screen is on. Otherwise you will get an ERROR 138 (device NAK). 


4.2. Menu Screen 


- Select action: - Esc 
Set S2USHELL as D1 + 


(Un)Mount ATR-File + 


(example menu screen) 
Inthe menu screen you can select and mount disk image via the keys. 


Key 1: “- Select Action: Esc -”:press this key to go back to Main 
screen, see above 

Key 2: “Set SHELL as D1”:the disk image \INT\S2USHELL.ATR on 
the internal memory will be mounted and activated on disk station 1 (the image 
contains a DOS and the program S2USHELL.COM. For a description of funti- 
ons see next chapter); then the SIO2USB jumps back to the main screen (see 
main screen in the previous chapter). If that does not work, please check ifthe 
file S2USHELL.ATR is present in the directory \INT and if it is not accidentially 
mounted on disk station 2 or 3. In the latter case, use the keys 1 and 2 0r 3to 
swap the file. 

Key 3: “(Un)Mount file”: if you press this key, the SIO2USB will call 
the mount screen, see next chapter. 
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4.3. Mount Screen 


PATH=INT Esc 
<<Unmount File>> t 


TESTI <DIR> « 
TDOS21.ATR \ 


(example mount screen) 


This screen shows the beginning of the directory/subdirectory “root” (USB- 
Stick, if plugged in) of of the internal memory (if no USB-Device plugged in). 
The path is shown in line one. If it does not fit into line one because it it too 


long “..” will be shown in front to indicate that. 


Lines two to four show filenames or directories. Only mountable files and direc- 
tories will be shown. 


Key 1: ESCAPE - back to main screen 
Key 2: scroll up (if possible) 

Key 3: choose entry in line 3 

Key 4: scroll down (if possible) 


Scroll the filename you want to mount to line three, then press button three. 


If you want to unmount a disk image, scroll the line <unmount file> to line 
three, then press button three. 


If aname is selected which denotes a directory, subdirectory or parent directo- 
ry (“..”), pressing key three leads to the same screen but the contents of the 
chosen directory will be shown 


If the name is a file, the next screen (select screen) will show up. 
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4.4. Select Screen 


- Select drive: - Esc 
D1 


TDOS20.ATR D2 
D3 


(example select screen with filename selected) 


The file chosen in the mount screen stays visible in line three. Now you have 
to select in which disk station the file shall be mounted. 


Key 1: ESCAPE - back to main screen 

Key 2: Mount in D1-back to main screen thereafter 
Key 3: Mount in D2 -back to main screen thereafter 
Key 4: Mount in D3 - back to main screen thereafter 


- Select drive: - Esc 
D1 


<<Unmount File>> D2 
D3 


(example select screen with <<unmount file>> chosen) 


If <<Unmount file>> was chosen, the you have to select which disk station to 
unmount. 


Key 1: ESCAPE - back to main screen 

Key 2: Unmount D1 -back to main screen thereafter 
Key 3: Unmount D2 - back to main screen thereafter 
Key 4: Unmount D3 - back to main screen thereafter 
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5. SIO2USB Operation via Shell 


The following chapter is an introduction into the usage of the SIO2USB with 
the Shell program complete with examples of frequently used procedures. A 
detailed description of all commands can be found in chapter 6. 


5.1. Starting the SIO2USB-SHELL 


First mount the image S2USHELL.ATR using the keys on the SIO2USB (see 
chapter 4). 


You only need two keystrokes for that: press key 1 to go to main screen. Then 
press key 2t0o “Set Shell as D1” and the image with the Shell will be 
mounted as D1. 


If you want to go on using a disk previousiy mounted on D1 just swap itto D2 
or D3 before mounting the Shell image on D1 (use the keys to swap images, 
see chapter 4.1.3). 


After a reboot/coldstart of your computers the Shell is automatically started. 


% Another device being present on the SIO-BUS configured as D1 must be 


switched off before reboot (e. g. disk station 1050, SIO2PC or similar)! The 
data transfer will be disturbed, because two devices would answer as D1: 
when the ATARIT’" sends commands. 


% The file S2USHELL.ATR in the directory “\INT” must not be deleted! O- 
therwise the function described above would not be possible any more! 


% The file STIO2USB.CFe in the directory “*\INT” as well as the file 


SIO2USB.CFG in the directory root “\” on the USB-stick must not be deleted. 
They contain settings about which images are mounted and activated. If an 
USB-stick is plugged in the file from the stick is used. If no stick is plugged in, 
the file from the directory “\INT” is used. 
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5.2. Copy the SIO2USB-SHELL to a Disk 


We advise you to copy the Shell program to a diskette and store that diskette 
in a safe place and do not use it for everyday use. 


Mount the Shell as described in chapter 5.1. After that swap the images D1 
and D2 (command “swA 1 2“ using the Shell; or use the keys, see chapter 
4.1.3). 


% D1 must not be mounted or active. Now switch on your disk drive D1 or 
your SIO2PC. 


Leave the Shell using the command ou1. Start a disk copy program which 
supports two drives simultanously (e. g. DISKCOPY.COM which comes with 
TurboDOS on the S2USHELL.ATR image) as D1 and insert a blank disk into 
disk station D1. Please refer to the instructions that came with the DOS or pro- 
gram on how to use the copy program. 


5.3. Copy Diskettes/Files to the SIO2USB 
To copy real diskettes to disk images do as follows: 


As described above, connect the SIO2USB and boot the computer. The Shell 
will be started. 


Create a new image with the command MAK <name>.ATR xD”. For xD please 
state SD, MD or DD as the density you want. For “<name>” please state a 
name of your choice for the image, not more than 8 characters long. 


Mount the newly created image with “MOU <name>.ATR x”, where x is the 
number of the disk station and <name> is the name of the image. Use 3 for x, 
so 1 is kept free for your real disk station (or SIO2IDE or SIO2PC etc.) and 2 is 
kept for the virtual disk with the SIO2USB-Shell. 


Now leave the shell using the command “Dos”. You will be transferred to DOS. 


Format the disk image in the correct density which you have chosen two steps 
before. Do not forget to put aDOS on the disk if needed. Now you can copy 
files or whole diskettes from the real disk station number 1 (or from SIO2PC or 
from SIO2IDE etc.) to the virtual diskette in disk station 3. The disk image will 
be updated. When you want to change the image to another image, use the 
Shell (see chapter 5) or the keys (see chapter 4). 
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5.4. Copy Disk Images to the SIO2USB 


To copy whole disk images in ATR-format from the harddisk of aPC or Mac to 
the USB-stick, you can plug the USB-stick into aPC or Mac computer. Then 
you can copy the images files from the hard disk to the USB-stick using Micro- 
soft Windows, Apple MacOS X or Linux. 


Another way would be to mount the images via SIO2PC, then create and 
mount a new image with the same size and density on the SIO2USB and then 
copy the files via DOS or diskcopy program. 


Just imagine that the SIO2USB acts as three normal disk stations. Create i- 
mages with the MAKE comand in the Shell, mount them with MOUNT and ac- 
tivate them with ENABLE if needed. Then you can access files or whole disket- 
tes like real diskettes. Remember to format the images first in the correct den- 
sity. 
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6. The Shell 


6.1._ Overview 


The Shell is used to control the funtions of the SIO2USB without using the 
keys beside the display. Some commands of the shell can be used directly by 
pressing the keys on the SIO2USB (see chapter 4). 


The Shell is used to manage virtual disk images on the internal memory or on 
USB-sticks plugged into the SIO2USB. With the Shell you can “insert”, “swap”, 
“activate” etc. disk images. You can create and delete directories, create, dele- 
te, rename and copy disk images. Furthermore, you can show and set the date 
and time and check the hardware status. 


6.2. _ Commands 


General: 
<file> denotes a filename in 8.3 format, where the first 8 characters are the 
filename and the 3 characters after the dot “.” denote the file-extender. 


<\file> denotes a filename with path 


<dir> denotes a path. Use a backslash “\” between the directory names (press 
“CONTROL” and “+”, to type a “”), alternatively slash is allowed too (see be- 
low). 


{albIc} means choose between the stated options. 


The disk identifier can be written with colon “:” or semicolon “; 


x denotes the number of a disk station, possible options are 1,2 and 3 or D1:, 
D2: and D3: 


Only the first three characters of a command are interpreted, so you can ab- 
breviate all commands to 3 characters (see the examples of the commands). 


A 


Allowed characters for input are: [A..2] [a..2] [0.9] ; =. /\_- 
* ? and the blank “ “. The semicolon will be changed to a colon, slash “/” to 
backslash “\”. Small characters will be capitalized. 


Some filenames from PC or Mac contain the tilde sign “-”, which is not part of 
the ATARI"”-font. The SIO2USB as well as the Shell change the tilde “-” in the 
display into the roof sign *“”. 


% While the Shell is used don’t press any of the keys. This may lead to 
different displays on the SIO2USB and in the Shell output. 
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DIR <file> 

Shows the contents of the current directory on the USB-stick or of the built in 
memory. <file> can be used with the wildcards “*” and “?”. If there was nothing 
stated, *.* will be used. 


Examples 

DIR *.ATR shows all files with the extender .ATR in the current 
directory on the USB-stick or the built in memory 

DIR A*.COM shows all files in the current directory on the USB-stick or 


the built in memory beginning with A and having .COM 
as extender 


DIR Dx:<file> (x=[1|2]|3]) 

Shows the directory of a disk. Instead of the colon the semicolon can be used. 
<file> can be used with wildcards. If there was nothing stated, *.* (show all) will 
be used. 


Examples 
DIR D2: shows the directory of D2: 
DIR D3; shows the directory of D3: 


DIR D1:*.ATR shows all *.ATR-files of D1: 


CAT <file> 

Shows the contents of the current directory on the USB-stick or of the built in 
memory with hidden files, system files, volume information and with size, date 
and time of the directories. <file> can be used with wildcards. If there was not- 
hing stated, *.* (show all) will be used. 


Examples 

CAT *.ATR shows all files with the extender .ATR in the current 
directory on the USB-stick or of the built in memory 

CAT BRM*.COM shows all files in the current directory on the USB-stick or 
the built in memory starting with BRM and having .COM 
as extender 
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TIME 
Shows the current time and date in the format: 
HH:MM:SS DD.MM.YY (hours:minutes:seconds day.month.year) 


Examples 
TIME 
TIM 


Remark: if an image on the SIO2USB is altered using write access by the A- 
TARI"Y, time and date of the image will be refreshed. 


TIME hh:mm:ss dd.mm.yy 
Sets the current time and date. 


Example 
TIM 21:15:10 25.10.07 


STATUS 

Shows the status of the SIO2USB interface. In detail: version and date of 
bootware and firmware, serial number, status of the built in memory and of the 
USB-medium, if present and detected FAT errors. 


Example 
STATUS 
STA 


Output example 
BOOTCODE V:04.13.04 D:16.03.07 
FIRMWARE V:03.04.04 D:16.03.07 
SERIAL NUMBER: 0003 
MEDIA STATE: 
EXT.MEDIA: - 
INT.MEM: DETECTED,CONFIGURED, MOUNTED 
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CD <dir> 

Changes the path to the stated directory. 

“CD \” changes to the uppermost directory (“root”). If there is no USB-medium 
plugged in, “CD \” changes to the directory “\INT\’ on the built in memory, and 
error $35 will be printed. 

“CD ..” changes to the parent directory if possible, else error $35 will be prin- 
ted. 


Examples 

CDATR changes from the current directory \to \ATR 

CD ATR\EINS changes from the current directory \to \ATR\EINS\ 
CD .. changes to the parent directory 

CD\ changes to the root directory 

CD \INT changes to the directory \INT on the bulit in memory 


CoPY <filel> <\file2> 
Copies a file. A path can be stated at the destination filename. 


Examples 

COPY SPIELE.ATR GAMES.ATR copies the file SPIELE.ATR 
to GAMES.XFD 

COP GAMES.ATR SPIELE\GAMES2.ATR copies the file GAMES.ATR 
to SPIELE\GAMES2.ATR 


MOUNT 
Shows the status of the virtual disk drives D1: bis D3: . 
# means disk station empty 


= filiename means disk inserted and active 
# fiiename means disk inserted and not active 


Example 
MOUNT 
MOU 


Output example: 
MOUNT STATUS 


Dl: = INT\S2USHELL.ATR 
D2: # DEMOS.ATR 
D3: # 
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MOUNT <\file> x 
Inserts a diskette and activates the virtual disk station. Attention: it is not pos- 
sible to mount an image to a second drive while it is already mounted! 


Examples 

MOUNT TEST.ATR DIl: inserts the file TEXT.ATR as ‘diskette’ into the 
virtual disk station D1: and activates it. 

MOU \ATR\GAME.ATR 2 inserts the file GAME.ATR from the sub- 
directory \ATR as ‘diskette’ into the virtual 
disk station D2: and activates it. 

UNMOUNT x 

Deactivates the given virtual disk station and removes the diskette. 

Examples 

UNMOUNT D1: deactivates the virtual disk station D1: 

UNM 2 deactivates the virtual disk station D2: 

SWAP xl x2 


Exchanges/swaps the diskettes between the stated virtual disk stations without 
changing their activation status (see ENABLE, DISABLE). 


Examples 

SWAP Dl: D2: swaps the diskettes between D1: and D2: 
SWA 3 2 swaps the diskettes between D3: and D2: 
ENABLE x 


Aktivates the stated virtual disk station, provided there is a disk inserted (see 
MOUNT) 


Examples 
ENABLE D2: activates the virtual disk station D2: 
ENA 1 activates the virtual disk station D1: 
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DISABLE x 
Deactivates the stated virtual disk station, provided it is active. 


Examples 
DISABLE D2: deactivates the virtual disk station D2: 
DIS 3 deactivates the virtual disk station D3: 


MAKE <\file> <dens> 

Creates anew disk image with the filename <\file> and the density <dens>, 
where <dens>= { SD I MD | DD I XX }. XX=free image size, the number of sec- 
tors and the size of the sectors will be requested in a second step. The new file 
gets the current time and date. 


Examples 

MAKE GAME.ATR SD creates a single density image in ATR format 
with the name GAME.ATR 

MAK \INT\SPIELE.ATR DD creates a double density image in ATR-format 
with the name SPIELE.ATR 


MKDIR <dir> 
Creates a new directory named <dir>, which gets the current time and date. 


Examples 

MKDIR LEER creates a directory named “LEER” in the 
current directory 

MKDIR VERZNS\VOLL creates a subdirectory named “VOLL” in the 


directory “VERZNS” 


RMDIR <dir> 
Deletes a directory. Attention: the directory has to be empty! 


Examples 

RMDIR LEER deletes the (empty!) directory LEER 

RMD REEL deletes the (empty!) directory REEL 

RMDIR ATR\EMPTY deletes the (empty!) subdirectory EMPTY in 
the directory ATR 

RMD ATR\YTPME deletes the (empty!) subdirectory YTPME in 
the directory ATR 
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LOCK <\file> 
Locks the stated file (set write protection). <file> can be used with the wild- 
cards * and ?, but when using wildcards no path can be stated. 


Examples 

LOCK GAME.ATR locks the file GAME.ATR 

LOC ATR\SPIELE.ATR locks the file SPIELE.ATR in the 
subdirectory ATR 

LOC *.* locks all files in the current directory 


UNLOCK <\file> 
Unlocks the stated file (remove write protection). <file> can be used with the 
wildcards * and ?, but when using wildcards no path can be stated. 


Examples 

UNLOCK GAME.ATR unlocks the file GAME.ATR 

UNL ATR\SPIELE.ATR unlocks the file SPIELE.ATR in the 
subdirectory ATR 

UNLOC *.* unlocks all files in the current directory 


DELETE <file> 
Deletes the stated file. Attention: only possible, when the file is not mounted 
and activated. <file> can be used with the wildcards * and ?. 


Examples 
DELETE GAME.ATR deletes the file GAME. ATR 
DEL ATR\SPIELE.ATR deletes the file SPIELE. ATR in the 


subdirectory ATR 


RENAME <filel> <file2> 

Changes the name of the given file or directory. 

If the file is mounted it will be renamed and then unmounted. 

If you have renamed a file with a long filename (PC-filename with more than 
8.3 characters) the link between the long filename and the short filename will 
be lost. You can repair this by using SCANDISK on the PC or “Harddisk Utility” 
on the Mac. 

Renaming a directory containing a mounted file is possible but is not recom- 
mended. The image will not be found according to the configuration file 
SIO2USB.CFG after a reset or coldstart. 
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Examples 
RENAME GAMES.ATR SPIELE.ATR 


REN SPIELE.ATR SPILLER.ATR 


DOS / EXIT / QUIT 
Ends the shell and start the DOS. 


Examples 
DOS 

QUIT 
EXIT 
ouI 

EXI 


COLDSTART / BYE 


renames the file GAMES.ATR to 
SPIELE. ATR 

renames the file SPIELE. ATR 
to SPILLER. ATR 


After a security request a coldstart is done to the computer. 


Examples 
COLDSTART 
COL 

BYE 


HELP 


Shows a short overview of allthe commands and their syntax. 


Examples 
HELP 
HEL 
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SIO2USB Instructions 


7. Updating the Firmware 


The software of the SIO2USB consists of two parts. The permanent bootcode 
and the exchangable firmware. The bootcode is used to update the firmware. 


If a new firmware has to be installed all needed is an image with the new firm- 
ware. The image can be found on our webpage (see chapter 1.3.2). 


The image contains the new firmware and a tool called FLASHER to upload it. 
Boot the computer by using this image. Either copy itto a real diskette, use a 
SIO2PC or copy it to the USB-stick. 


% If the firmware on the SIO2USB is not usable any more, you can’t 
update via USB-storage. 


7.1. Operation of the FLASHER software 


After booting the image the software starts automatically. On the computer 
screen you see information about the SIO2USB and the new firmware. 


Should the SIO2USB not be found by the software you will get an error mes- 
sage. Check the connections and if the power-LED is lit and ifthere can be 
something seen on the LC-display. 


Press “R” to restart tne FLASHER software and to start a new try to connect to 
the SIO2USB interface. 


Press “P” to upload the software to the SIO2USB interface. 
You can watch the upload with the progress bar growing. 


If everything is correct the software will state so and resets the SIO2USB and 
restarts the FLASHER software. After that, the version of the firmware is indi- 
cated. 


After that the program can be left by pressing “Q” for DOS or CONTROL-”C” 
for coldstart. 


7.2. Non-working Firmware 


If the firmware is not functional (e. g. non successful update) the SIO2USB will 
stop its booting process. 


The LC-display will shows something like this: 
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SIO2USB*HWSN#### 
BC:030601-190707 


FW:<INVALID> 
Restore old FW=> 


(Example bootcode screen) 


The “*” in the first line should be an alternating dash ‘-’ and ‘1’. The numbers 
behind BC indicate the version and date of the bootcode, the number behind 
FW state the same for the firmware. The #### behind HWSN is the serial 
number of the device. Allnumbers (dates, versions) will be larger or newer with 
development of the software. 


Should the SIO2USB stop in this menu, you can only update the firmware via a 
real diskette or SIO2PC. 


Ifthere is "Restore old Fw=>" printed in the last line on the display, it is 
possible to restore the old firmware version, see next section. 


7.3. Restore an older Version of the Firmware 


If the firmware was working before trying to update it, it is possible to restore 
the old version with the bootcode but without any other help. 


To start the bootcode, power up the SIO2USB with key 1 pressed. Power up 
means do a coldstart on your computer or switch it off and on again. 


The display shows the screen as printed above. 


Press key 4 “Restore old FW=>" and a you will be requested to confirm 
your selection. After that the old firmware will be restored and the SIO2USB 
restarts. 
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8. Error Codes and Glossary 


8.1. General Information concerning Error Messages 


If an error occurs during data transmission or during the execution of com- 
mands an errors message will be shown in the Shell. On errors during the 
command execution the error-LED lights up briefly. 


If a FAT structure error was detected, the red LED lights up and the error will 
be shown in the Shell output. The red error-LED will stay lit. 


Remark: the error LED will only stop lighting after a SIO2USB reset. 


% If a FAT structure error is detected it is mandatory not to do any 


write operations any more. Otherwise data could be corrupted on the 
USB-media or the internal memory! 


If the USB-stick is affected remove it and repair it using an utility program on a 
PC or Mac. 


If the internal memory is affected it has to be reformatted. 
Warning: all data on the internal memory will be lost during format. 


To format the internal memory the program from the disk image FORMAT.ATR 
is used. This image is provided on the USB-stick. 


After booting the image the program will start automatically. All functions are 
described within the program. It is possible to format the USB-stick too. Like 
described above, all data on the USB-stick will be lost during format! 


8.2. Errorcodes 


Code Description 
(Hex) 
500 No Error 


$01 to $1F Transmission error 


$20 FAT-structure error on internal memory 
$21 FAT-structure error on USB memory 
$20 FAT-structure error on internal memory 
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$21 

$22 
$23 
$24 
$25 
$26 
$27 
$28 
$29 
$2A 
$2B 
$2C 
$2D 
$2E 
$32 
$33 


534 


$35 
$36 
$37 


$38 


FAT-structure error on USB memory 

Internal memory is not configured 

USB device is not configured 

FAT sector at internal memory is not readable or writable 

FAT sector at USB device is not readable or writeable 

FAT file or directory is Read Only 

Requested ATARI sector is not inside the image 

Illegal Data frame length 

Received PERCOM density does not match to the image length 
Directory entry number is out of range 

USB device can't be enumerated 

Media capacity can’t be read 

Unexpected command length byte 

Unexpected command content 

USB device is not mounted 

Internal memory is not mounted 

FAT Filename or directory name has zero length or is longer than 
12 characters or name is longer than 8 character or extender is 
longer than 3 characters 

No such directory or filename found 

Unexpected structure at mount, enable, disable command 
Filename / directory already exists or double mount error 


Not enough free memory available 
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$39 No free root entry found or filename extension shall be ATR 
or invalid ATR file 


$3A Can’t erase a folder which is not empty 


$3B Directory copy is not supported or copy of system files, hidden 
files, volume descriptor not supported 


$3C Illegal characters found 


8.3. Glossary 


FAT-filesystem File system of PCs and Macs which is also used by the 
SIO2USB (File Allocation Table) 


SIO2USB.CFG This file contains information about the images which are 
currentliy mounted. The file exists on the USB-stick and 
on the internal memory. The file on the USB-stick is used 
preferably. Ifthere is no USB-stick plugged in the file from 
the internal memory is used. 


S2USHELL.ATR Diskette image with the SIO2USB shell as autorun.sys file 


Wildcards are the characters ““” and “?”, which are used as jokers for 
the specification of filenames. “?” means on arbitrary 


character, “” means no, one or any number of arbitrary 
characters. 

Examples 

NET? .COM finds NETZ.COM, NETT.COM but not NET.COM or 
NETTE .COM 

NET*.COM finds NET.COM, NETZ.COM, NETT.COM, NETTE.COM, 


NETTOYER.COM 
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SIO-BUS 


USB 


S2USHELL 


Firmware 


ATR-Datei 


SIO2USB 


The Serial-Input-Out-Bus of the ATARI’”, data from the 
computer to the peripherals are transmitted here in 
serial order 


Universal Serial Bus, a contemporary serial data bus for 
mice, keyboards, scanners, printers, memory-sticks 


The user interface to handle the functions of the SIO2USB 


The built in software which provides all the functions of the 
SIO2USB 


A file containing the contents of a ATARI(tm) diskette as 
direct data image. 


Abbreviation/acronym for SIO to USB 


34 Chapter 8 Error Codes SIO2USB User Manual 


9. Background 


9.1. The Developers 


Thomas Grasel Specification, hardware, SIO2USB software (boot- 
code and firmware), Flasher software, frontplate, 
assembly, overall coordination 


Harry Reminder USB-Cartridge, hardware, test software, tests, test 
documentation, casing, assembly, translation 

Carsten Strotmann USB-DOS for USB cartridge, tests 

Florian Dingler Flasher software, Shell (DUP for SIO2USB), tests, 


assembly, user manual, translation, reference card, 
packaging design 


Support: Roland Reminder, Hans Boffo, Mathias Hüsler 


We want to say a big “thank you” to everybody not mentioned here who contri- 
buted his or her help! 


9.2. The Stoy behind the SIO2USB 


It all began in 2003. Single density 5 1/4 diskettes were more and more hard to 
get and the ABBUC-RAF the regional group of the ABBUC computer club star- 
ted to think about a suitable solution. We closely examined the existing SIO2I- 
DE which was easily available at that time. Missing documentation, no casing, 
the need for an external power supply and some things more showed us that 
the SIO2IDE did not fullfil our needs. 


What to do? Continue to improve the SIO2IDE or develop something comple- 
tely new? 


The USB-interface then was gaining more and more market share, it was well 
documented (as we thought) and prices were in acceptable regions. 


To understand the USB-interface and its functionality we had to develop and 
build a rudimental interface. The USB-cartridge by Guus Assmann was a- 
vailable as a prototype, but was not usable for our application. After redesig- 
ning it and including an USB-controller we were able to present a well docu- 
mented and fully functional USB-cartridge for the ATARI"” 8-Bit computer line, 
complete with functional input devices: we connected a steering wheel and 
used a slightly patched version of Pole Position’“©. At the annual convention 
of the ABBUC club 2005 an astonished crowd could give it atry on the race 
track! 
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We established contact to USB but there were several difficuties waiting for us. 


Thomas and Harry designed and layouted multiple circuit diagrams and printed 
circuit boards for the SIO2USB interface. Electrical components, dependen- 
cies, feature and possibilities were checked, discussed, discarded and rede- 
signed more than once. 


In 2006, the hardware prototype was finally functional. Circuit boards for a 
couple of interfaces were built for the further development of the firmware and 
software tools. The interfaces were complete with displays, SIO-connectors 
and casings. 


Harry wrote the first drivers for the ATARI’”, cleanly integrated into the ATA- 
RI’" operating system. Florian wrote tools like the “Flasher-Software” (no pun 
intended!) for the firmware upload. Thomas wrote the firmware, completly in 
machine code. More than one error threw us days and weeks behind our own 
time schedule. The S2USHELL was developed and coded, the bug hunt and 
testing was coordinated by Harry using a detailed list of reported errors. That 
way everybody in the developer team was on the same standard of information 
all the time and error were easier to locate and fix. 


At the end of April 2007 we decided that everything was developed far enough 
to give it a “Go!” for the production. Everything was functional in a way that we 
could see a finish line at the horizon. Thomas set up a webpage announcing 
the availability of the SIO2USB interface and all ATARI’” fans worldwide were 
informed. Within days we had 20, 30, 50 preorders! 


The first “hands-on” experience for the public was in July atthe Fujiama con- 
vention in Lengenfeld. Equipped with SIO2USB hardware, prelimenary version 
of the instruction manual, USB-stick and preliminary shell programm, interes- 
ted user were allowed to make their own impressions of the interface. Praise, 
encouragement and a couple of good hints were the results for our team. 
Thomas took his time to discuss details and design, although improving of the 
firmware was planned for that time. On the other hand these discussions gave 
us substantial progess. After the Fujiama the procurement of the components 
was due. Thanks to many users who paid even more than the preorder price, 
we were able to buy alltne components and do the financing. It was almost a 
5-digit number of money for all the stuff we needed! Thanks again to all users! 


In mid-August all the components for the first delivery lot were complete and 
we began to look for dates to start producing. Assembly and soldering took 
place between 25.08.2007 and 14.10.2007. Also the casings were routed, 
frontplates were milled and affixed. Alltogether more than 300 man-hours were 
needed for assembly. 
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Parallel to the hardware development this instruction manual was written, re- 
written and optimized. At last translated into English, printed, stapled and fol- 
ded. Boxes were bought, stickers were fixed to them, everything put togehter 
and finally packaged. 


The result of all the work lies in your hands, your SIO2USB interface. 


The developer team wishes all users many happy hours with the most 
complicated hardware developed for the ATARI(tm) in recent years and 
say thank you to all helping hands for their support! 
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Notes 
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